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TITLE: METHOD FOR ACCESSING OBJECT LI29KIN6- EMBEDDING 

DATABASE DATA VIA JAVA DATABASE CONNECTIVITY 

FIELD OF THE INVENTION; 

This disclosure provides a mechuism that 
enables a JAVA application to use JAVA dateO^ase 
connectivity (JDBC) to access data made available by an 
object -linking and embedding database data provider. 

CROSS-REFERENCES TO RELATED APPLICATIONS; 

This application is related to a concurrent 
pending application entitled "^Method For Accessing 
Hierarchical Data Via JDBC'S filed on October 30, 2001, 
as U.S. Serial No. 09/021,525. 
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BACKGROUND OF THE INVENTION; 

The specification for the JDBC API is a 
document which is the JAVA platform standard call-level 
application program interface (API) for database access. 

5 This API assumes that the database being connected to is 
a relational dataJDase* It is understood that relational 
databases have flat tsQ>le structures where tables consist 
solely of columns and rows* 

An on-line linking and embedding database is 

10 the preferred application program interface (API) for 
Microsoft and is used by applications running on a 
Window-based PC to access data from a variety of data 
sources, including databases both relational and non- 
relational, flat files, directory services and so on. 

15 JDBC (JAVA Database Connectivity) is the JAVA Application 
Program Interface (API) used to access data in relational 
databases. While typical Windows programs written in C++ 
or Visual Basic had, in the OLE DB (Online Linking and 
Embedding Database) , a standardized mechanism for 

20 accessing data in a variety of data sources, however, the 
JAVA applications were limited to accessing only 
relational data sources. It is desirable to provide JAVA 
applications which have access to the same data as other 
Windows applications. 

25 The present system and method provides a 

mechanism which enaibles a JAVA application to use JAVA 
database connectivity (JDBC) to access data which is made 
available by an OLE DB data provider. 

The OLE DB API provides four basic objects that 

30 are used to access data. Each object implements a series 
of required and optional interfaces. The JDBC API 
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defines over a dozen objects that can be used to access 
data. The JDBC driver for the OLE DB data access 
(designated as a Driver in this document) maps the dozen 
objects defined by the JDBC API to the objects in the OLE 
DB API. This includes mapping the methods on the JDBC 
object to the various interfaces on the OLE DB objects. 
Additionally, the OLE DB API requires that only three of 
the four basic objects actually be implemented. Thus, 
part of the solution concerns here, concerns how the 
Driver handles situations where an OLE DB data provide 
does not support an optional object or interface that is 
required to complete a JDBC call. 

In the related prior art, there have been seen 
a number of systems which may be related somewhat 
partially to the present disclosure. These systems 
involve U.S. Patents which are briefly described 
hereinunder . 

U.S. Patent 6,016,499 entitled ^System And 
Method For Accessing A Directory Service Repository''^ 
describes a method for using a relational API to data 
stored in another format, in this particular case for 
directory data, using an Application Program Interface 
(API) native to data. However, the present disclosure is 
considerably different in that it uses the JDBC API 
(while the cited patent uses ODBC and the present system 
provides access to any data that uses OLE DB as an 
application program interface. 

Another U.S. Patent 5,893,118 is entitled 
^^Method For Managing Globally Distributed Software 
Con^onents'' and describes a mechanism for locating a JAVA 
class using a directory service. The present invention 
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is quite considerably different in that it is a bridge 
from ODBC over to the OLE DB. 

Another U.S. Patent 5,848,273 entitled ^^Method 
For Generating OLE Automation And IDL Interfaces From 
NetaData Information'' describes a mechanism for 
generating an OLE-based API from repository MetaData. 
The present system and method is quite different in that 
no API is generated, but rather instead the system uses 
an existing API, namely the ODBC- Additionally, the 
present disclosure actually does make use of the OLE DB 
API. 

Another possible relevant patent is U.S. Patent 
5,689,664 entitled ^Interface Sharing Between Objects" 
which concerns a mechanism for reducing memory usage when 
an object is shared by two different processes, typically 
using a drag-and-drop operation. However, quite 

contrarily, the present system concerns database access, 
rather than reducing memory usage. 

A further U.S. Patent 5,910,804 entitled «OLE 
For Design And Modeling" is used to describe several 
tools used to do 3-D modeling and has an interface, in 
OLE, used by those tools to communicate the data 
concerning the object being modeled. This particular 
system is quite different from the present invention, 
since the present invention translates ODBC API calls 
into the appropriate OLE DB API calls, thus to enable 
JAVA applications to access data available via the OLE 
DB. 

The presently described system can map a dozen 
objects as defined in the ODBC API and map them to 
objects in the OLE DB API. 
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SUMMARY OF THE IMVEHTIONt 



The system and method of the present invention 
provides a mechanism which enables a JAVA application to 
use the JAVA database connectivity (JDBC) progreua to 
access data which is made available by an object -linking 
and embedding database data provider (OLE DB) . 

While Online Embedded Datea>ase API {OLE DB) is 
the preferred API for applications running on Windows- 
based PC's to access data from many types of data 
sources, (including relational and non-relational 
databases) , however, JDBC (Java Database Connectivity) is 
the JAVA Application Program Interface (API) used to 
access data in relational databases. 

In the OLE DB, typical Windows programs written 
in C++ or Visual Basic had a standard mechanism for 
accessing data in a variety of data sources. However, 
JAVA applications were limited to access onto only 
relational datea>ases. 

The present method enables JAVA applications 
with access to all the same types of data as do the other 
Windows applications using OLE DB. This is accomplished 
via a JDBC ^Driver" which «maps" the dozen objects 
defined by the JDBC API to the objects in the OLE DB API. 

Since the OLE DB API provides 4 basic objects 
to access data (where each object in^lements a series of 
required and optional interfaces) and the OLE DB API 
requires only 3 of the 4 basic objects to be implemented, 
the present method provides a ODBC Driver to handle each 
situation where the OLE DB data provider does not support 
an optional object or interface required to complete a 
JDBC call. 
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BRIEF DESCRIPTION OF THE DRAWINGS: 

Fig. 1 is a illustration showing the classes 
and interfaces for the JAVA database connectivity 
specification program; 
5 Fig. 2 is a schematic diagram showing various 

on-line embedding database objects and their various 
relationships ; 

Fig. 3 is a drawing showing how a ODBC driver 
can act as a bridge between the JAVA application and the 
10 OLE DB data provider; 

Fig. 4 is a diagram illustrating correspondence 
of objects between a JAVA class and a corresponding C++ 

class for each interface defined in the JDBC API; 

mi 

Fig. 5 is a flowchart drawing which illustrates 
Wi 15 the process of establishing a connection with the 
Q database; 

Fig. 6 is a flowchart that illustrates the 
process of creating a Statement Object; 

Fig. 7 is a flowchart illustrating the process 
20 of creating a *PreparedStatement or CallableStatement 
object; 

Fig. 8 is a flowchart illustrating the process 
of executing a database command; 

Fig. 9 is a flowchart illustrating the process 
25 of executing a database command using a 
JPreparedStatement or JCallableStatement object; 

Fig. 10 is a flowchart illustrating the process 
of obtaining the ResultSetMetaData object for a given 
ResultSet object; 
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Fig. 11 is a flowchart that illustrates the 
process of obtaining the DatabaseMetaData object for the 
session; 

Fig. 12 is a flowchart illustrating the process 
of obtaining a ResultSet object from the database and 
obtaining the corresponding ResultSetMetaData object. 
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GLOSSARY OF RELEVANT TERMS: 

1. API; This represents an application programming 
interface. A set of routines used by an application 
progrctm to direct the performance of procedures by 
the computer's operating system. 

2. C++; An object-oriented version of the C 
progreumaing language developed in the early 1980' s 
at Bell Laboratories, and adopted by a number of 
vendors • 

3. C++ OBJECTS : Objects define in software written in 
the C++ language. 

4. DESCEMDANT: In object-oriented programming, a class 
(group) that is a more specialized form of another 
higher level class, thus, a descendant table would 
be a more specialized form of a higher level table, 
such as a parent table. 

5. DL/I.TM; This represents an object in an 
application's views database which is the root of an 
object's framework and a root for a collection of 
application views in the IBM information management 
system database. 

6. DMSII: This represents a data management system 
formulated by the Uliisys Corporation of Blue Bell, 
Pennsylvania . 

7. DRIVER (ODBC) ; This is a software program that 
implements the ODBC specification. 
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8. EMBEDDED RESULT SET (FOR THE COLTOIN ) ; A result set 
used to represent hierarchical data for a level 
other than the outermost parent level. An embedded 
result set always represents the value of a column 
in a parent result set. 

9. EMBEDDED RESULT SET OBJECTS; Once or more objects 
that represent embedded result sets. 

10. FLAT-FILE DATABASE; A database that takes the form 
of a table, where only one table can be used for 
each database. A flat- file database can only work 
with one file at a time* 

11. getObject method; See Qlossary Item #49^ 

12 . HIERARCHICAL DATABASE; A database in which records 
are grouped in such a way that their relationships 
form a branching tree-like structure. This type of 
database structure, most commonly used for with 
dat6Q>ases for large computers, is well -suited for 
organizing information that breaks down logically 
into successively greater levels of the table. 

13. IMS.TM; This represents the information management 
system which is an IBM database muagement system to 
manage computerized databases. 

14* INSTANTIATE; To create an instemce of a class. An 
instance" is an object in object-oriented 
programming, in relationship to the class to which 
it belongs. For example, an object MYLIST that 
belongs to a class LIST, is an instance of the class 
^^List". 
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15. INTERNET BROWSER: An application used to view pages 
on the World-Wide -Web. Many e-business applications 
use internet browsers to present their user 
interface. So it becomes the GUI for such 
applications. Such applications also make use of a 
JDBC driver to access data in a database. 

16. J2EE APPLICATION; A Java application written to 
conform to the Java 2 Platform, Enterprise Edition 
specification* 

17. J2EE APPLICATION SERVER: A Java application written 
to the Java 2 Platform, Enterprise Edition 
specification. Many e-business applications are 
written to run within a J2EE application server, 
which provides a container for such application. A 
J2EE Application Server accesses database data via a 
JDBC driver. 

18 . JAVA APPLICATIONS : An application written in the 
Java language. The application will access data in 
a database via the JDBC driver. 

19. JAVA CLASS NAME; The name of the Java class used as 
the type of the value of a column in a result set. 
The value for said column is made available to a 
Java progr€u& as an instance of said Java class. 

20. JAVA CLASS NAME (FOR GIVEN COLUMN IN A RESULT SET ) : 
(See JAVA CLASS NAME above) 

21. JAVA. SQL. RESULT SET: The full name of the ResultSet 
class in the Java language. 

22. JAVA. SQL. TYPES. OTHER: A value for the JDBC type of 
a column « This value is defined by the JDBC API 

specification. 
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23. JDBC; This acronym indicates Java Data Base 
Connectivity, which is used to access data in a 
particular database involved. 

24. »JDBC API SPECIFICATION : A doctunent from Sun 
Microsystems, Inc. that describes the JDBC API. 
This document designated JDBC™ API is the Java™ 
platform standard call -level API for database 
access. The document contains the final 
specification of the core JDBC 2.1 API which is 
Copyright 1999 by Sun Micro Systems, Inc. 901 San 
^tonio Road, Palo Alto, California 94303 • 

25. JDCB DRIVER; Software that implements the JDBC API 
specification. It provides remote access to 
database data. That is, that database is on another 
computer, and a first JDBC Driver communicates with 
a second JDBC driver to provide access to the data 
in that database. 

26. JDBC DRIVER: Software that implements the JDBC API 
specification and provides access to data in a 
database . 

27. JDBC TYPE ; The type, as defined by the JDBC API 
specification, of a column in a result set. 

28. LDAP; This represents lightweight directory access 
protocol implemented by the IBM Corporation. 

29. LOGICAL DATA ACCESS LAYER ; A layer of software used 
to map the physical data, as stored in a database, 
to a logical view of that data. 

30. LOGICAL ENTITY TYPES: Types that do not represent 
physical storage of data, but rather a rearranging 
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o£ that data used to represent a specific object 
model • 

31. LOGICAL ENTITY TYPES -ATTRIBUTE NAMES: Names of the 
attributes of logical entity types. 

32 . METADATA; This is data about data. For exeuaple, 
the title, subject, author, and size of a file, 
constitute metadata about the file. 

33. METADATA COLLECTION ; One or more result set 
metadata objects that are tracked by a result set 
object. 

34. BCETADATA VALUE ; The metadata associated with a 
given entity. 

35. METAFILE; A file that contains or defines other 
files. Many operating systems use metafiles to 
contain directory information about other files on a 
given storage device. 

36. NEWLY CREATED RESULT SET METADATA OBJECT : A result 
set metadata object that is created to represent the 
metadata in a result set. 

37. NORMAL FASHION; This represents processes already 
defined by the ODBC API specification. 

38. NT SERVER: A computer running an operation system 
based on Microsoft's NT technology, such as Windows 
2000 or Windows NT 4.0. The Java application JDBC 
driver and OLE DB data provider all run on this 
computer • 
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39 . OBJECTS This is designation for object code 
(macliine readable code) . In object oriented 
programming, a variad>le comprising both routines and 
data that is treated as a discrete entity. 

40. OBJECT MODEL ; The structural foiudation for an 
object-oriented lemguage, such as 04*+ • This 
foundation includes such principles as abstraction, 
concurrency, encapsulation, hierarchy, persistence, 
polymorphism, and typing* 

41. OLE: This represents object linking and embedding. 
This is a technology for transferring and sharing 
information among applications. When an object, 
such as an image file is created with a ^^painf 
program, it is then linked to a compound document, 
such as a spreadsheet or a document created with a 
word processing program. The document contains only 
a reference to the object; any changes made to the 
contents of a linked object will be seen in the 
compotmd document. When an object is embedded in a 
expound document, the doctunent contains a copy of 
the object; any changes made to the contents of the 
original object will not be seen in the compound 
document, unless the einbedded object is updated. 

42 . OLE DB DATA PROVIDER: Software that implements the 
Microsoft OLE DB API specification. It provides the 
interface between the JDBC driver and the database. 
The code that implements the OLE DB API for a 
particular dated^ase is known as the OLE DB data 
provider. 

43. PARENT RESULT SET OBJECT; A result set object that 

contains embedded result set objects. 
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44. PARENT TABLE: Pertaining or constituting 
relationship between two nodes in a tree data 
structure in which the parent is one step closer to 
the root, that is to say, one level higher than the 
descendent or child. 

45. PHYSICAL TABLES; The actual tables defined in a 
relational database. 

46. QUERY; This is the process of extracting data from 
a dateQ>ase and presenting it for use. It involves a 
specific set of instructions for extracting a 
particular data repetitively through a program 
sequence • 

4 7 . RELATIONAL DATABASE ; A database or database 

memagement system that stores information in tables 

rows and columns of data and conducts 

searches by using data in specified columns of one 
table to find additional data in mother table. In 
relational database, the rows of a table represent 
records (collections of information €J>out separate 
items) and the columns represent fields (particular 
attributes of a record) . In conducting searches, a 
relational database matches information from a field 
in one table with information on a corresponding 
field of another table to produce a third table that 
combines requested data from both tables. 

For example, if one table contains the fields 
EMPLOYEE-ID, LAST-NAHE, FIRST-NAME, HIRE-DATE 
cuid another table contains the fields DSPT, 

EMPLOYEE-ID, SALARY, a relational database 

can match the EMPLOYEE -ID fields in the two 

tables to find such information as the names of 
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all employees earning a certain salary or the 
departments o£ all employees hired after a 
certain date. Thus, relational database uses 
matching values in two tables to relate 
information in one table to information in the 
other t€U3le. 

48. RESULT SET : A type in the ODBC API used to define 
data returned by a database in response to a query. 

4 9 . RESULT SET . GET OBJECT : A method defined on the 
ResultSet type used to obtain the value of a column 
in the current row of the result set. 

50. RESULT SET (HIERARCHICAL DATABASE ) ; For a 
hierarchical database, the data at each level of the 
hierarchy is represented in Java as a result set. 

51- RESULT SET METADATA: A class that defines the 
metadata associated with a result set. 

52 . RESULT SET METADATA. GET COLUMN TYPE: A method 
defined on the ResultSetMetadata class that is used 
to obtain the JDBC type of a given column in a 
result set. 

53. RESULT SET METADATA OBJECT: An instance of the 
ResultSetMetadata class. 

54. ROW CURSOR: An entity employed by a result set to 
mark the currently accessed row of a result set. 

55. STORAGE: Represents the database, in this case, a 
hierarchical database. It contains the data being 
accessed. 
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EXTENDED GLOSSARY ITEMS: 

XI. JDBC CLASSES : Classes (used in object-oriented 
prograsuaing sense) that implement the JDBC API. 

X2. JDBC INTERFACES : Interfaces (used in the object- 
5 oriented programming sense, also used in COM) that 

define the JDBC API. 

X3. DriverManager ; A class defined in the JDBC API 
that is used to manage JDBC drivers. JDBC drivers 
register themselves with the DriverManager, and client 
10 applications request JDBC drivers from the 

^ DriverManager • 

O X4. CONNECTION (FIG. 1) : An interface defined in the 

M JDBC API that is used to represent the connection 

yf between a Java application and a database. 

15 X5. STATEMENT ; An interface defined in the JDBC API 

Jfi; that xs used to represent an SQL statement. 

R X6. PREPARED STATEMENT : An interface defined in the 

%t 

CI JDBC API that is used to represent an SQL statement 

r|t 

that has been pre-processed by the database. 

20 X7. CALLABLE STATEMENT ; An interface defined in the 

JDBC API that is used to represent the invocation of a 
stored procedure in the database. 

X8. ResultSetMetaData : An interface defined in the 
JDBC API that is used to represent the information 
25 about (or metadata of) the data in a result set. 
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X9. YIELDS ; Returns. In the diagram, this is meant to 
indicate that the interface at the starting point of 
the arrow contains a method that returns the interface 
indicated by the ending point of the arrows. 

XIO* OBJECT : An instance of a class (in the classic 
object-oriented sense) 

Xll. DATASOURCE (20, FIG. 2); An object defined by the 
OLE DB API that represents the code used to provide 
database access to a client program. 

X12 • JDBC : JDBC stands for Java Database Connectivity, 
and is an API that is used by Java application to 
communicate with relational databases. 

X13. SESSION ; An object defined by the OLE DB API that 
represents the connection between a client application 
and a database. 

X14. ROWSET ; An object defined by the OLE DB API that 
represents the data retuxmed by a database from a query 
on the database. 

X15. ICOMMAMD : An interface on the Command object in 
the OLE DB API that enables a client application to 
execute a command, such as an SQL statement, against a 
database. 

X16. lOPENROWSETU ; An interface on the Sessions object 
in the OLE DB API that enables a client application to 
access the data in a table in the database. 
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3^17. OLE DB OBJECTS : Objects (in the object-oriented 
sense) that are defined by the OLE DB API. 

^18. NATIVE METHODS ; The mechanism defined in the Java 
language that enables a Java application to invoke 
functions written in others languages, typically the C 
and C++ languages. 

X19. DATA LIMK LIBRARY ; A program library that enables 
the Java portion of this invention to communicate with 
an OLE DB data provider. The data link library is part 
of this invention. 

X20. JDBC DRIVER ; An implementation of the JDBC API. 
A JDBC Driver provides Java clients with access to data 
in a datiLbase. This invention describes a specific 
JDBC Driver. 

X21. OLDB DATA PROVIDER ; An implementation of the OLE 
DB API. An OLE DB Data Provider provides applications 
with access to data in a datad>ase. 

X22. DataBaseMetaPata t An interface defined in the 
JDBC API that is used to represent the data about the 
data stored in a database. Such data includes things 
such as what tables and columns are defined in the 
database . 

X23. JResultSet; An interface defined in the JDBC API 
that is used to represent the connection between a Java 
application and a database. 

X24. JDriver Object; An instance of the JDriver class, 
which is written in Java, and implements the Driver 
interface defined by the JDBC API. This class is part 
of this invention. 
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CSession Object ; An instance of the CSession 
class, which is written in C++, that provides the 
implementation of the native methods necessary to allow 
communication between the JSession class and the OLE DB 
API. This class is part of this invention. 

JStatement Object ; An instsuice of the JStatement 
class, which is written in Java, and implements the 
Statement interface defined by the JDBC API. This 
class is part of this invention. 

^27. JPreparedStatement ; A class, which is written in 
Java, that implements the PreparedStatement interface 
defined by the JDBC API. This class is part of this 
invention. 

J CallableStatement ; A class, which is written in 
Java, that implements the CallableStatement interface 
defined by the JDBC API. This class is part of this 
invention. 

X29. JResnltSet Object ; An instance of the JResultSet 
class, which is written in Java, and implements the 
ResultSet interface defined by the ODBC API. This 
class is part of this invention. 

X30^ JResnltSetMetaPata Object ; An instance of the 
JResultSetMetaData class, which is written in Java, and 
implements the ResultSetMetaData interface defined by 
the JDBC API. This class is part of this invention. 
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X31. JPataBaseMetaJData : A class, which is written in 
Java, that implements the DataBaseMetaData interface 
defined by the JDBC API. This class is part of this 
invention. 

X32. JDatetbaseMet€J>ata Ob j ect ; An instance of the 
JDatabaseMetaData class, which is written in Java, and 
implements the DatabaseMetaData interface defined by 
the JDBC API. This class is part of this invention* 

X33. CStatement ; A class written in C++, that provides 
the implementation of the native methods necessary to 
allow communication between the JStatement class and 
the OLE DB API. This class is part of this invention. 

X34. CDriver Object ; An instance of the CDriver class, 
which is written in C++, that provides the 
implementation of the native methods necessary to allow 
communication between the JDriver class and the OLE DB 
API. This class is part of this invention. 

X35. CSession Object ; An instauice of the CSession 
class, which is written in C++, that provides the 
implementation of the native methods necessary to allow 
communication between the JSession class and the OLE DB 
API. This class is part of this invention. 

X36. CStatement Object : An instance of the CStatement 
class* 
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CPreparedStatement ; A class written in C++, that 
provides the implementation of the native methods 
necessary to allow communication between the 
JPreparedStatement class and the OLE DB API. This 
class is part of this invention. 

X38. CCallableStatement ; A class written in C++, that 
provides the implementation of the native methods 
necessary to allow communication between the 
JCallableStatement class and the OLE DB API. This 
class is part of this invention. 

X39. CCallableStatement Object ; An instance of the 
CCallableStatement class. 

CResnltSet Object s An instance of the CResultSet 
class. 

X41. CResttltSetMetaPata Object ; An instance of the 
CResultSetMetaData class, written in C++, that provides 
the implementation of the native methods necessary to 
allow communication between the JResultSetMetaData 
class and the OLE DB API. This class is part of this 
invention. 

CDataBaseMetaData Object ; An instance of the 
CDataBaseMetaData class. 

CDataBaseMetaData ; A class written in C++, that 
provides the implementation of the native methods 
necessary to allow communication between the 
JDataBaseMetaData class and the OLE DB API. This class 
is part of this invention. 
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X44. CResultSet: A class written In C++, that provides 
the Inaplementatlon of the native methods necessary to 
allow communication between the JResultSet class and 
the OLE DB API. This class is part of this invention. 

X45. COMMAND OBJECT ; An object defined in the OLE DB 
API. The Command object represents a command, such as 
SQL statements, that can be executed against the data 
in a database. 

X46. DATA SOURCE OBJECT ; (same as Data Source (20, 
Fig. 2) . 

X47. SESSION OBJECT ; (same as Session. 

X48. Throw SQLException : This relates to how error 
handling is done in Java, which iavplements structured 
exception handling. Code that notices an error 
condition ^throws'' an exception. Other code then 
^^catches'' the exception and handles the error (usually 
by displaying an error message.) Both ^throfir^ and 
^^catch'' are part of the Java language. 

X49. RECORD COUNT : The ntimber of database records 
affected by a command on a database. 

X50. lOPENROWSET ; (see lOpenRowset) . 

X51. ROWSET OBJECT ; (same as Rowset) . 

X52. COLUMN INFORMATION ; Information about the columns 
in a Rowset object. 
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DESCRIPTION OF PREFERRED EMBODIMENT; 

Fig. 1 is a drawing to illustrate how a JAVA 
application makes use of the JAVA Database Connectivity- 
Application Program Interface (JDBC API) to access data 
in a relational database. This diagr2uii is oriented from 
the viewpoint of what the JAVA application has to do, but 
not from the viewpoint of what the JDBC Driver, which 
implements the JDBC API, has to do. 

Fig. 1 shows a JAVA application 10 connected to 
a Driver 11, a Connection unit 13 and a ResultSet 18. 
The Driver unit 11 connects for two-way communication to 
the DriverManager 12, while the Connection unit 13 
connects to the DatabaseMetaData 17 which connects to the 
ResultSet 18. 

The JAVA application 10 also inter -communicates 
with the Statement 14, which is generated by the 
Connection unit 13 and provides output as a ResultSet 18. 
The Statement 14 extends to the PreparedStatement 15 
which extends to the CallableStatement 16. The ResultSet 
18 provides a connection to the ResultSetMetaData 19. 

The interrelational operations of Fig. 1 are shown 
in a series of steps designated Al through A12, as 
follows. 

At step Al, the JAVA application uses 
reflection to load the Driver class 11. 

At step A2, the Driver class, during 
initialization, creates one instwce of itself and 
registers that instance with the DriverManager class 12. 
The Driver class 11 is a singleton • 
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At step A3, the JAVA application requests a 
connection from the DriverManager 12 via the passing of a 
connection string. 

At step A4, the DriverManager 12 asks the 
Driver 11 if the Driver recognizes the Connection string. 

At step A5, if the Driver does recognize the 
string, it creates a Connection object 13 and returns it 
to the DriverManager 12 which returns the Connection to 
the JAVA application, 10. 

At step A6, the JAVA application then asks the 
Connection 13 for a Statement 14. This is for one-time 
use in SQL statements, and for a PreparedStatement 15 
(used for multiple -use SQL statements that can take input 
parameters) or asks the Connection 13 for a 
CallableStatement 16 (for multiple use SQL statements 
that can take input and output parameters) . 

At step A7, the Connection 13 creates the 
desired Statement object 14 and returns it to the JAVA 
application, 10. 

At step A8, the JAVA application then executes 
the Statement. If the SQL statement is an update (or 
other non-query) , the Statement object returns to the 
JAVA application an indication of how many rows were 
updated in the database. 

At step A9, if the SQL statement is a query, 
the Statement object 14 returns a ResultSet object 18 to 
the JAVA application. 

At step AlO, the JAVA application can then 
request information about the database from the 
Connection object 13. The Connection object returns a 
DatabaseMetaData object 17, which the application can use 
to get such information. it is noted that some of this 
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informaition is returned in the form of a ResultSet 18 on 
line step All. The ResultSet object 18 returns a 
ResultSetMetaData object 17 to form the ResultSet 
MetaData object 19 via step A12. The ResultSetMetaData 
object 19 is one which the JAVA application 10 can use to 
get information as to the ResultSet MetaData object 19. 

Fig. 2 is a drawing illustrating the four 
primary objects used to access data in the database, for 
the OLE DB (Online Embedded Database) . Shown in Fig. 2 
is the Data Source object 20, the Session object 22, the 
Command object 24 and the Rowset object 26. Each of 
these objects implements multiple interfaces. The 
interfaces define functions that are availatble to a 
client program. These functions are what a client uses to 
access the database via the on-line embedded database OLE 
DB. 

As indicated in Fig. 2, a Windows application 
that wants to use the OLE DB to access a database then 
first creates a Data Source object 20. The application 
uses the CreateSession function in the IDBCreateSession 
interface to create a Session object 22. 

The application can then use the CreateCommand 
function on the IDBCreateCommand interface of the Session 
object to create a Command object 24. The application 
would then develop some command text, such as an SQL 
statement to the Command object 24, and then call the 
Execute function on the ICommand interface to cause the 
Command text to be processed. 

If the Command text yielded a table of result 
values, then a Rowset object 26 would be returned to the 
client application. The client application would use the 



awk\^pl\530L.doc 



26 



interfaces of the Rowset object 26 to obtain the contents 
of the table of result values. 

Alternately, the client application could 
directly ask for the contents of a particular table by 
using the Open Rowset function of the lOpenRowset 
interface defined for the Session object 22* This route 
bypasses the Command object 24. Since the OLE DB 
specification states that the Command object is 
^^optional'', then the use of the OpenRowset function 
allows non-relational databases to provide an OLE DB 
interface, provided that the data in that database can be 
accessed as named in the tables of information. The code 
that implements the OLE DB API for a particular dateGaase 
is known as the OLE DB data provider. 

Fig. 3 is an illustration showing that where 
Java applications cannot use the OLE DB API to access 
databases, the present system and method provides a 
solution by defining a ODBC Driver that acts as a bridge 
between the JAVA application and the OLE DB data 
provider. 

Here, the solution will be seen to consist of 

two parts: 

(i) A series of JAVA classes that implement 
the JDBC API and, 

(ii) A Data Link library, DLL, written in 0++, 
that implements methods defined as ^^native^' in 
the JAVA classes, and acts as an OLE DB client 
for an OLE DB data provider. 

Thus, in Fig. 3, the JAVA application 10 is linked to the 
JDBC Driver 11, whereupon native methods 28, using a Data 
Link Library, connect the JDBC to the OLE DB with the 
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result that there is provided at block 30, a OLE DB Data 
Provider. 

Fig. 4 is a diagram which illustrates a 
correspondence of objects using the ODBC Statement 
interface, as one particular example. 

Fig. 4 illustrates two separate interfaces, 
whereupon the Client 8 interfaces the ODBC Driver 11 
which interfaces the OLE DB 30. 

One major focus to the present system and 
method is that for each interface defined in the JDBC 
API, there exists both a JAVA class and a corresponding 
C++ class. A JAVA object maintains a reference to its 
corresponding C++ object. The C++ object in turn, 
maintains a reference to the OLE DB object 30 that most 
closely matches the functionality of the JDBC interface. 
In most cases, the C++ object maintains references to 
multiple interfaces defined by the OLE DB object, since 
it takes combinations of various interfaces to implement 
the desired JDBC ftmctionality. 

Thus, the diagram of Fig. 4 illustrates the 
correspondence of objects by using the JDBC Statement 
interface as a particular example. The JStatement object 
11 j a represents the JDBC Statement interface. 

The Statement interface is implemented by the 
JStatement class 11 j a. AssTuming that the Client 

application invokes the execute method, passing a 
database query, then the JStatement object 11 j a calls the 
execute function on the corresponding C++ CStatement 
object 11c. This object in turn, calls two functions on 
two different interfaces of the corresponding OLE DB 
Command object 30c. 
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The Java application wants to find all of the 
employees in the database. To do that, it uses the SQL 
database query ^^SELECT*FROM EMPLOYEES'', assuming that 
the dat£U3ase contains a teible called EMPLOYEES* To do 
5 this, it creates a JStatement object passing that SQL 
query to the object. The JStatement object creates a 
CStatement object, passing the SQL query to it. The 
CStatement object creates an OLE DB Command object and 
passes the SQL query to it. The OLE DB Command object 

10 issues the SQL query to the dateJ^ase and receives the 
data back, which is a t2Q>le consisting of the employees 
in the database. The OLE DB Commaxid object creates an 
fi^ OLE DB Rowset object and places the employee information 

into the OLE DB Rowset object, and returns that object to 

15 the CStatement object. The CStatement object creates a 
CResultSet passing a reference to the OLE DB Rowset 
object to it. The CStatement object return a reference 

CP 

F|ll to the CResultSet object to the JStatement object, which 

creates a JResultSet object, passing the reference to the 

"% 

Q 20 CResultSet object to it. The JResultSet object is 

m 

retuxmed to the Java application. The Java application 
can then use the API defined by the JDBC to access the 
employee information using the JResultSet object. When 
it does so, the JResultSet object calls on the CResultSet 

25 object, which calls on the OLE DB Rowset object, which 
passes the data about the employee back to the CResultSet 
object, which passes the data about the employee back to 
the JResultSet object which passes the data about the 
employee back to the Java application. 

30 The ICommandText: xSetCommamdText functions to 

set the text for the query, and secondly, the 
ICommand: : Execute comnAnd to execute the query. The 
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Command object 30c communicates the desired query to the 
database which performs the query and returns results. 
The Command object 30c creates a Rowset object 3 Or to 
handle the results of the query and passes a reference to 
that Rowset object back to the CStatement object 11c. 

The CStat emen t object 11c creates a CResultSet 
llcr making it reference the Rowset object 3 Or, and 
passes a reference to the newly- created CResultSet object 
llcr back to the JStatement object 11 ja. The JStatement 
object 11 j a creates a new JResultSet object 11 jr, making 
it reference the corresponding CResultSet object llcr, 
and returns a reference of the JResultSet object 11 jr to 
the Client 8. The Client 8 can then use the JResultSet 
object 11 jr, which implements the ResultSet interface 
defined by JDBC, to access the data returned by the 
database for the query. 

Now referring to Pig. 5, there is seen a 
flowchart illustrating the process of establishing a 
connection with the database. The process begins with 
the Start bubble Bl, followed by the creation of the 
JDriver object which is a JAVA object at block B2. Then 
the CDriver object (a C++ object) is created and the 
JDriver object is modified to reference this newly 
created CDriver object in step B3. 

The OLE DB DataSource object is created next 
and the CDriver object is modified to reference this 
newly-created DataSource object at step B4. The 
CreateSession function of the ZDBCreateSession interface, 
implemented by the DataSource object is then called, 
which yields an OLE DB Session object, as seen in step 
B5. 
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Then a CSesslon object (a C<f+ object) is 
created and made to reference the OLE DB Session object 
at step B6. A JSession object (a JAVA object) is created 
and made to reference the CSession object at step B7. A 
reference to the newly- created JSession object is 
returned to the client application at step B8. The 
process is exited at the end bubble Bd« 

Seen in Fig. 6 is a flowchart illustrating the 
process of creating a Statement object. The process 
begins with the Start bubble CI, followed by an inquiry 
as to whether or not the OLE DB data provider supports 
Command objects, as shown in the decision diamond at step 
02. If so, (YES) the Command object is created at step 
block C4 and then the C++ CStatement object is created 
which will reference the Command object at step block C5. 

If the OLE DB data provider does not support 
command objects (NO), then a C++ CStatement object is 
created which will reference the Session object created 
in the previous diagram (step B5) which is shown at block 
step 03* In either case, the processing continues with 
the creation of the JStatement object (a JAVA object) 
which is set to reference the newly- created CStatement 
object as seen in step block C6. A reference to the 
newly-created JStatement object is then returned to the 
client application at block step C7. That process is then 
exited and ended as seen by the End bubble at step C8. 

Now with reference to Fig. 7, there is seen a 
flowchart to illustrate the process of creating a 
PreparedS ta t eme n t object or a CallableStatement object. 

The process begins with a Start bubble at step 
Dl followed by an inquiry as to whether or not the OLE DB 
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supports Command objects or not, as seen at the decision 
diamond of step D2. 

If the OLE DB does not support command objects 
(NO), then an SQLException is thrown at step D3, and the 
process exits at the End bubble step D8. 

If the Command object is supported (YES) , the 
Command object is created at step D4, and then the C++ 
CPreparedStatement or the CCallableStatement object is 
created which will then reference the Command object at 
step D5. Processing continues with the creation of the 
JAVA JPreparedStatement or the JCall6J:>leStatement object, 
which is set to reference the newly- created 
CPreparedStatement or CCallableStatement object at step 
D6* 

A reference to the newly- created 

JPreparedStatement or the JCallableStatement object is 
returned to the Client application at step D7. Then, the 
process is exited as seen by the End bubble step D8. 

A flowchart is shown in Fig. 8 that illustrates 
the process of executing a database command using a 
JStatement object. 

The process begins with the Start bxibble El 
followed by an inquiry as to whether or not the C++ 
CStatement object references an OLE DB Command object, as 
seen in the decision diamond step E2 • If this is the 
case (YES) , the command is executed at step E5 which is 
followed by an inquiry as to whether or not the Command 
is a query, as seen in the decision diamond step E6. If 
the Command was a query (YES) , then an OLE DB Rowset 
object is created to handle the query results at step E9. 

Then a C++ CResultSet object is created which 
will reference the Rowset object at step ElO. Processing 
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continues with the creation of the JAVA JResultSet object 
which is set to reference the newly- created CResultSet 
object at step Ell. 

A reference to the newly- created JResultSet 
object is returned to the Client application at step E12 
and then the process is exited as seen by the End bubble 
£13. 

If the Command at step E6 was not a query (NO) , 
it will have generated a count of the ntimber of database 
records affected by the command, and this record count is 
returned to the Client at step E7, after which the 
process exits at the End bubble step E13* 

If the CStatement at step E2 does not reference 
etn OLE DB Command object (NO) , then it must be that the 
OLE DB data provider does not support Command objects, so 
that processing continues with an examination of the 
Command text to determine (step E3) if the command is a 
simple query, such as the SQL query text (^^SELECT*FROM 
table'') at the decision diamond step E3« If so (YES), 
the OpenRowset function of the lOpenRowset interface 
supported by the Session object is then called at step 
E8* This call yields a result much the same as executing 
a query command, so that processing continues with 
creation of a Rowset object to handle the query, as seen 
at step E9 via marker A, and so on through steps ElO to 
E13. 

If at step E3, the command was not a simple 
query (NO) , then an SQLException is thrown at block step 
E4 and the process then exits at the End bubble E13. 

Now referring to Fig. 9, there is seen a 
flowchart that illustrates the process of executing a 
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database command using a JPreparedStatement or a 
JCallableStatement object. 

Here in Fig. 9, the process begins with the 
Start bubble Fl, followed by the Command execution at 
step F2 which is followed by an inquiry as to whether or 
not the command is a query, seen as a decision diamond at 
step F3 • 

If the command was a query (YES) , then an OLE 
DB Rowset object is created to handle the query results 
at step F5. Then, a C++ CResultSet object is created 
which will reference the Rowset object at step F6. 

Processing continues with the creation of the 
JAVA JHesultSet object which is set to reference the 
newly-created CResultSet object at step F7. 

A reference to the newly-created JResultSet 
object is returned to the Client application at step F8, 
and then the process is exited as seen by the End bubble 
at step F9. 

If the command at step F3 was not a query, it 
will have generated a count of the number of dateJsase 
records affected by the Command, and this record coimt is 
then returned to the client at step F4, after which the 
process exits at the End bubble P9. Part of the ODBC API 
specification requires that when the database is updated 
that a count of the number of records updated be returned 
to the Java application. 

Now with reference to Fig. 10, there is seen a 
flowchart that illustrates the process of obtaining the 
ResultSet MetaData object for a given ResultSet object. 

Here, the process begins with the Start bubble 
Gl, followed by the creation of the C++ 
CResultSetHetaData object as seen in step G2. This 
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object obtains the column information from the Rowset 
object, as seen in step G3, which is used to create the 
JAVA JResultSetMetaData object at step G4. This is 
returned to the Client application at step G5, after 
which the process exits at the End bubble 66. 

A flowchart that illustrates the process of 
obtaining the DatabaseMetaData object for the Session is 
shown in Fig. 11. The process begins with Start bubble 
HI, followed by the creation of the C++ CDatabaseMetaData 
object which references the OLE DB Session object (22, 
Fig. 2) seen at step H2. 

Processing continues with the creation of the 
JDatabaseMetaData object which references the 
CDatabaseMetaData object seen at step H3, which is 
returned to the Client application at step H4, after 
which the process exits with the End bubble H5. 

Fig. 12 is an illustration using a flowchart to 
show the process of creating a Rowset object in order to 
return the JResultSetMetaData object to the client. 

The process begins with the Start bubble II, 
followed by the creation at step 12, of the OLE DB Rowset 
object. Then a C++ CResultSet object is created which 
will reference the OLE DB Rowset object at step 13. 

Processing continues with the creation of the 
JAVA JResultSet object, which is set to reference the 
newly-created CResultSet object at step 14. A reference 
to the newly- created JResultSetMetatData object is 
returned to the client application at step 15^ and then 
the process is exited at seen by the End bubble at step 
16. 

Described herein has been a method wherein the 
limitations of the JAVA API have been overcome so that 
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the JAVA API can now exercise the £unctlonallty for data 
access to many types of data sources that previously were 
only applic€a>le solely to the OLE DB API. Thus, the JAVA 
API cem now function with all of the versatility of OLE 
DB in accessing all the varieties of databases whether 
relational, non-relational, flat, directory types, or 
other forms. 

While one ezobodiment of the described method 
has been illustrated, it should be understood that other 
embodiments may still fall within the claims appended 
hereto • 
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